@database MagicMenu.guide @width 77 @Node Main "Magic Menu Anleitung" ************************************************************************** M A G I C M E N U V 1 . 2 9 ************************************************************************** 1992/93 Martin Kornd *************************** * * * W I C H T I G ! ! ! * * * *************************** BITTE AUF ALLE F LLE DIE @{" INSTALLATIONSHINWEISE " link InstallNote} LESEN!!! USER, DIE MAGIC MENU 1.21 ODER LTER VERWENDET HABEN, SOLLTEN AUF JEDEN FALL DIE @{" ENTWICKLUNG " link History} LESEN! I N H A L T =========== 1. Einf hrung @{" 1.1 Motivation " Link Motivation} @{" 1.2 F higkeiten " Link Features} @{" 1.3 Systemvoraussetzungen " Link Requirements} 2. Installation @{" 2.1 Aus der Workbench " Link InstallWB} @{" 2.2 Aus dem CLI " Link InstallCLI} @{" 2.3 WICHTIGE ANMERKUNG " Link InstallNote} @{" 2.4 Magic Menu beenden " Link Removing} 3. Konfiguration @{" 3.1 Grunds tzliches " Link ConfBasic} @{" 3.2 Pull Down Menus " Link ConfPDBasic} @{" 3.2.1 STANDARD " Link ConfStandard} @{" 3.2.2 PRESSONCE " Link ConfPressOnce} @{" 3.2.3 SELECT " Link ConfSelect} @{" 3.2.4 3D-LOOK " Link Conf3D-Look} @{" 3.2.5 STANDARD-LOOK " Link ConfStandard-Look} @{" 3.3 Pop Up Menus " Link ConfPUBasic} @{" 3.3.1 STANDARD " Link ConfStandard} @{" 3.3.2 PRESSONCE " Link ConfPressOnce} @{" 3.3.3 SELECT " Link ConfSelect} @{" 3.3.4 3D-LOOK " Link Conf3D-Look} @{" 3.3.5 STANDARD-LOOK " Link ConfStandard-Look} @{" 3.3.6 CENTER BOXES " Link ConfCenter} @{" 3.4 Keyboard control " Link ConfKCBasic} @{" 3.4.1 ENABLE " Link ConfKCEnable} @{" 3.4.2 MOUSE TO BAR " Link ConfMouseToBar} @{" 3.4.3 START SEQUENCE " Link ConfKCStart} 3.5 Die restlichen Schalter @{" 3.5.1 TYPE " Link ConfType} @{" 3.5.2 MARK SUB MENUS " Link ConfMarkSub} @{" 3.5.3 DOUBLE BORDERS " Link ConfDBorder} @{" 3.5.4 MENU TIMEOUT " Link ConfTimeout} @{" 3.5.5 HIDE " Link ConfHide} @{" 3.5.6 SAVE " Link ConfSave} @{" 3.5.7 QUIT " Link ConfQuit} @{" 3.6 Tool Types " Link ConfToolTypes} @{" 3.6.1 SMARTPATCH " Link ConfSmartPatch} @{" 3.6.2 CHECKWB " Link ConfCheckWB} @{" 3.6.3 USELAYER " Link ConfUseLayer} @{" 3.6.4 KC_RALTRCOMMAND " Link ConfKCRAltRCommand} @{" 3.6.5 CX_PRIORITY " Link ConfCXPrio} @{" 3.6.6 CX_POPUP " Link ConfCXPopUp} @{" 3.6.7 CX_POPKEY " Link ConfCXPopKey} @{" 3.6.8 DONOTWAIT " Link ConfDontWait} @{" 3.6.9 TOOLPRI " Link ConfToolPri} @{" 3.6.10 STARTPRI " Link ConfStartPri} 4. Tastaturbelegung @{" 4.1 Hotkeys " Link Hotkeys} 4.2 Bei der Men auswahl @{" 4.2.1 In allen Modi " Link CtrlKeys} @{" 3.6.2 Tastatursteuerung " Link KCKeys} 5. Hinweise und Probleml sungen @{" 5.1 Fragen & Antworten " Link Questions} @{" 5.2 Problemecke " Link Problems} @{" 5.3 Infos f r Programmierer " Link Profi} 6. Geschichtliches @{" 6.1 Entwicklung " Link History} @{" 6.2 Geplante Features " Link Future} 7. Der Abspann @{" 7.1 Credits " Link Credits} @{" 7.2 Nutzungsbedingungen " Link Licence} @endnode @Node "Motivation" 1.1 Motivation ************** Bei der Entwicklung von AmigaOS 2.0 haben die Entwickler das Erscheinungs- bild der Amiga-Oberfl che auf sehr beeindruckende Art und Weise berar- beitet. Nur leider haben sie die Intuition Men s dabei vergessen... Da ich dem tristen Men -Altag entfliehen wollte und mich die diversen Programme, die es daf r so gibt, alle nicht so zufriedenstellen konnten, habe ich mich eben selbst an die Tastatur gesetzt... (ausserdem macht es vieeeel Spass den Amiga zu programmieren!) @endnode @node "Features" 1.2 F higkeiten *************** Folgende Features bietet Magic Menu: o Alle Intuition Men s werden durch Magic Menu ersetzt. Also kommen alle Programme, die die standard System-Men s verwenden, in den Genu MagicMenu Features. o Magic Menu unterst tzt sowohl @{" Pull-Down Men s " Link ConfPDBasic} wie auch @{" Pop-Up Men s " Link ConfPUBasic} o Die Darstellung der Men s erfolgt entweder im konventionellen @{" Standard-Look " Link ConfStandard-Look} oder im modernen, AmigaOS 2.0 konformen @{" 3D-Look " Link Conf3D-Look} o Die Men nnen vollst ndig ber die @{" Tastatur " Link ConfKCBasic} gesteuert werden, damit endlich der l stige Griff zur Maus entf o Es werden drei unterschiedliche Bedienungsmethoden angeboten: @{" Standard " Link ConfStandard}, @{" Press Once " Link ConfPressOnce} und @{" Select " Link ConfSelect} o Magic Menu kann auf vielf ltige Art @{" Konfiguriert " Link ConfBasic} werden, so k Bedienung und das Erscheinungsbild von Pull-Down und Pop-Up Men getrennt eingestellt werden o Von jedem(!) Men merkt sich Magic Menu genau, welche Punkt(e) zuletzt ausgew hlt wurden, und verh lt sich beim erneuten den Aufruf des Men so, da dieser oder benachbarte Punkte sehr schnell aktiviert werden k nnen. o wird das Men aktiviert w hrend der gerade aktive Screen nicht sichtbar ist (da er von einem anderen Screen berdeckt wird), so wird der Screen, auf dem das Men angezeigt wird, nach vorne geholt. Nach der Auswahl ist wieder alles wie zuvor. o Erfolgt w hrend einer einstellbaren Zeit keine Bedienung (Mausbewegung, Tastendruck), so wird die Men auswahl automatisch beendet, damit der Rechner nicht unn tig blockiert wird. und und und.... @endnode @Node "Requirements" 1.3 Systemvoraussetzungen ************************* Es gibt nur eine einzige Voraussetzung f r Magic Menu, n mlich da Rechner mit Amiga OS 2.04 (37.175) oder besser ausgestattet ist. Auch mit Kickstart 3.0 l uft Magic Menu ohne Probleme, das Programm passt sich sogar an einige spezielle F higkeiten des neuen Betriebssystems an. tzliche Libraries sind nicht notwendig. Anwender mit Kickstart 1.3 oder lter m ssen leider mit einem Requester vorlieb nehmen, der sie darauf aufmerksam macht, da sie IMMER noch nicht up-to-date sind... @endnode @node "InstallWB" 2.1 Installation von der Workbench aus ************************************** Magic Menu besteht nur aus einem einzelnen Programm. Die einfachste Installation erfolgt ber die Workbench. Dazu mu das Icon "MagicMenu" in der Schublade "WBStartup" der Boot-Partition gezogen werden. Dadurch wird das Programm automatisch bei jedem Neustart des Systems geladen und aktiviert. Damit nicht bei jedem Neustart das @{" Einstellungsfenster " Link ConfBasic} von Magic Menu ffnet wird, sollte im Informationsfenster des MagicMenu Icons der @{" Tool Type " Link ConfToolTypes} CX_POPUP=FALSE" eingestellt werden. Wie das Informationsfenster der Workbench funktioniert steht im Amiga Handbuch. Die Konfiguration von Magic Menu wird im Programmicon gespeichert. Man kann die Einstellungen ndern, in dem man die Tool Types direkt ver ndert, wesentlich einfacher ist es aber, alles im Programm nach den eigenen W nschen ber das Dialogfenster einzustellen. Magic Menu erzeugt die entsprechenden TOOL TYPES automatisch wenn die Konfiguration abgespeichert wird. @endnode @Node "InstallCLI" 2.2 Installation ber das CLI ***************************** Auch bers CLI l t sich Magic Menu starten. Die Einstellungen werden auch dann aus der .info Datei von Magic Menu gelesen. Das Icon mu also immer mitkopiert werden. Magic Menu koppelt sich selbstst ndig von dem CLI ab, so da der Befehl RUN nicht ben tigt wird. Ein erneuter Start von Magic Menu l t das @{" Einstellungsfenster " Link ConfBasic} erscheinen. Kommandozeilenparameter existieren in der aktuellen Version nicht. @endnode @Node "InstallNote" 2.3 WICHTIGE ANMERKUNG! *********************** Magic Menu ist darauf angewiesen einige Betriebssystemroutinen zu patchen. Das ist eine problemlose Angelegenheit, so lange kein anderes Programm die gleichen Routinen patcht. Es kann vorkommen, dass sich Magic Menu nicht mehr aus dem Speicher entfernen kann, wenn sich ein anderes Programm in die Routinen einklinkt. Magic Menu stellt das selbstst ndig fest und gibt eine entsprechende Meldung aus. Um Probleme dieser Art ganz auszuschliessen, sollte das Programm "SaferPatches" von Martin Adrian oder ein anderes, dementsprechendes Programm verwendet werden. Wird SaferPatches mit Magic Menu verwendet, sollte die @{" TOOL TYPE " Link ConfToolTypes} Option @{" SMARTPATCH " Link ConfSmartPatch} auf NO gestellt werden. Sonst IMMER auf YES lassen!!! Querverweise: @{" Bekannte Probleme mit MagicMenu " Link Problems} @{" Informationen f r Programmierer " Link Profi} @endnode @Node "Removing" 2.4 Magic Menu beenden (Uninstall) ********************************** Magic Menu kann auf drei Arten aus dem System entfernt werden: - Im @{" Einstellungsfenster " Link ConfBasic} von Magic Menu auf QUIT dr cken. ber das Steuerprogramm Exchange, das auf der Workbench im Tools/Commodities Verzeichnis zu finden ist. - Mit einem Ctrl-C, das dem Magic Menu Proze gesendet wird. Es kann allerdings vorkommen, da Magic Menu nicht sofort aus dem System entfernt werden kann. Das kleinere Problem ist wenn ein Programm noch nicht auf eine Nachricht von Magic Menu geantwortet hat, sobald die Antwort eintrifft, kann Magic Menu beendet werden, trifft die Nachricht nie ein, so hat Magic Menu ein Timeout eingebaut. Sehr viel problematischer ist der Fall, da ein Programm, das nach Magic Menu gestartet wurde, die selben Betriebssystemroutinen gepatcht hat. Magic Menu erkennt das automatisch, und zeigt eine entsprechende Meldung an. Meist bleibt einem dann nur noch Magic Menu zu deaktivieren, es verbleibt dann ruhig und friedlich im Speicher. Die Auswahl "Force uninstall" sollte nur dann getroffen werden, wenn man wirklich wei , was man tut, da sonst die einwandfreie Funktion des System nicht mehr gew hrleistet ist. Siehe dazu auch die @{" Installations Anmerkung " Link InstallNote} und der Tool Type @{" SMARTPATCH " Link ConfSmartPatch} @endnode @Node "ConfBasic" 3.1 Grunds tzliches zur Konfigurierung ************************************** Magic Menu speichert alle Einstellungen in den @{" TOOL TYPES " Link ConfToolTypes} seines eigenen Icons ab. Nat rlich k nnen diese Tool Types von Hand ge ndert werden, bei einigen wenigen ist das auch die einzige M glichkeit. Die meisten Optionen nnen aber bequem ber eine Graphische Oberfl che modifiziert werden. Um das Einstellungsfenster von Magic Menu zu ffnen gibt es drei glichkeiten: - Das Programm ein zweites mal aufrufen - Mit Hilfe des Programms "Exchange" (auf der Workbench im Verzeichnis Tools/Commodities zu finden): Den Eintrag "MagicMenu" anw hlen und "Show Interface" anklicken. - Der einfachste Weg ist aber ber den @{" Hotkey " Link ConfCXPopKey} von Magic Menu. Wenn er nicht ge ndert wurde ist das die Tastenkombination --. Das Fenster ist in vier Bereiche aufgeteilt: - Einstellungen f r @{" Pull-Down Men s " Link ConfPDBasic} - Einstellungen f r @{" Pop-Up Men s " Link ConfPUBasic} - Einstellungen f r die @{" Tastaturkontrolle " Link ConfKCBasic} - Allgemeine Schalter, die das Verhalten von Magic Menu in allen Modi beeinflussen. Das Fenster kann jederzeit mit dem Close-Gadget in der oberen linken Fensterecke oder ber den Knopf @{" HIDE " Link ConfHide} geschlossen werden, dabei bleibt Magic Menu aber im System erhalten. Mit @{" SAVE " Link ConfSave} kann die aktuelle Einstellung gespeichert werden. Dazu werden die TOOL TYPES in dem Icon, von dem aus Magic Menu gestartet wurde, entsprechend modifiziert. Der Knopf @{" QUIT " Link ConfQuit} dient zum Entfernen von Magic Menu. @endnode @Node "ConfPDBasic" 3.2 Pull Down Men ******************* ... sind genau das, was man als Amiga Anwender unter den Standard Men gewohnt ist. Also, in der Screenleiste eine Men zeile, beim Anw hlen eines punktes wird eine Meb box nach unten aufgeklappt. Die Pull-Down Men s von Magic Menu arbeiten genauso, nur da man zwischen den zwei folgenden Darstellungsformen w hlen kann @{" Standard-Look " Link ConfStandard-Look} @{" 3D-Look " Link Conf3D-Look} und das Men auf vier Arten bedienen kann (die @{" Tastatursteuerung " Link ConfKCBasic} jetzt mal ausser acht lassend): @{" Standard " Link ConfStandard} @{" Press Once " Link ConfPressOnce} @{" Select " Link ConfSelect} Welche dieser Methoden bzw. Darstellungsarten Magic Menu verwenden soll, wird im linken Bereich des @{" Einstellungsfensters " Link ConfBasic} festgelegt. @endnode @Node "ConfPUBasic" 3.3 Pop Up Men **************** Viele Amiga Anwender werden diese Option zuerst etwas ungewohnt empfinden, man gew hnt sich aber recht schnell daran, und dann ist es eine sehr bequeme Art, eine Men auswahl zu treffen. Im Gegensatz zu den normalen @{" Pull-Down Men s " Link ConfPDBasic} werden nach dem aktivieren des s die einzelnen Punkte nicht in der Titelzeile des Screens angezeigt, sondern es erscheint ein Kasten, genau da, wo sich der Mauszeiger gerade befindet, in dem die Men punkte untereinander aufgef hrt sind. Man spart sich also den Weg, mit der Maus in die Men leiste zu fahren. Ansonsten funktioniert alles, wie bei den normalen Pull-Down Men s gewohnt, so gibt es auch hier die zwei Darstellungsformen @{" Standard-Look " Link ConfStandard-Look} und @{" 3D-Look " Link Conf3D-Look} und die drei verschiedenen Modi, das Men zu bedienen: @{" Standard " Link ConfStandard} @{" Press Once " Link ConfPressOnce} @{" Select " Link ConfSelect} tzlich existiert noch eine Einstellung namens @{" CENTER BOXES " Link ConfCenter}, die die Bedienung noch weiter vereinfachen soll. Welche dieser Methoden bzw. Darstellungsarten Magic Menu verwenden soll, wird im mittleren Bereich des @{" Einstellungsfensters " Link ConfBasic} festgelegt. @endnode @Node "ConfStandard" 3.2.1 / 3.3.1 STANDARD Bedienung ******************************** Magic Menu verh lt sich in der Standardeinstellung genau wie man es vom Amiga Betriebssystem gewohnt ist: Nach dem Druck auf die rechte Men taste erscheint die Men leiste (entweder als Pull-Down oder als Pop-Up Men , je nach Einstellung des @{" Men typs " Link ConfType}). Die Men leiste bleibt nur so lange sichtbar, wie man die rechte Maustaste gedr ckt h lt. Sobald man den Mauszeiger ber einen Men punkt bewegt, werden die Auswahlpunkte dieses Men s angezeigt. Um einen bestimmten Punkt auszuw hlen, setzt man die Maus ber das gew nschte Feld und l t die rechte Maustaste los. Um einen Men punkt auszuw hlen ohne das Men zu verlassen, kann - ebenso wie bei den Intuition Men s - die linke Maustaste auf dem entsprechenden Punkt ckt werden. @{" TOOL TYPE " Link ConfToolTypes}: f r @{" Pull-Down Men s " Link ConfPDBasic}: PD_BUTTONMODE=STANDARD f r @{" Pop-Up Men s " Link ConfPUBasic}: PU_BUTTONMODE=STANDARD Andere Bedienungsarten: @{" Press Once " Link ConfPressOnce} @{" Select " Link ConfSelect} @endnode @Node "ConfPressOnce" 3.2.2 / 3.3.2 PRESS ONCE Bedienung ********************************** Besonders f r Trackball-Besitzer, aber auch f r alle anderen, bringt diese Einstellung eine deutliche Erleichterung. Die rechte Maustaste mu hrend der Men auswahl nicht mehr st ndig gedr werden, sondern ein kurzer Klick gen Dann wird die Men leiste angezeigt (entweder als Pull-Down oder als Pop-Up , je nach Einstellung des @{" Men typs " Link ConfType}), und man kann genau wie in der @{" Standard-Einstellung " Link ConfStandard} mit der Maus die Men s durchsehen. Um einen Men punkt auszuw hlen mu entweder die rechte oder die linke Maustaste gedr ckt werden. Dr ckt man eine der Maustaste ausserhalb des bereichs, so wird die Men auswahl abgebrochen. Um einen Men punkt auszuw hlen ohne das Men zu verlassen, mu die linke Maustaste zusammen mit der Shift-Taste bet tigt werden. @{" TOOL TYPE " Link ConfToolTypes}: f r @{" Pull-Down Men s " Link ConfPDBasic}: PD_BUTTONMODE=PRESSONCE f r @{" Pop-Up Men s " Link ConfPUBasic}: PU_BUTTONMODE=PRESSONCE Andere Bedienungsarten: @{" Standard " Link ConfStandard} @{" Select " Link ConfSelect} @endnode @Node "ConfSelect" 3.2.3 / 3.3.3 SELECT Bedienung ****************************** Die Einstellung, die ich pers nlich am bequemsten finde - besonders f @{" Pop-Up Men s " Link ConfPUBasic}. Wie bei der @{" PressOnce " Link ConfPressOnce} Einstellung, mu die rechte Maustaste nur einmal kurz ckt werden und die Men leiste wird angezeigt (entweder als Pull-Down oder als Pop-Up Men , je nach Einstellung des @{" Men typs " Link ConfType}). Im Gegensatz zu den anderen Bedienungsmodi werden jetzt die Men punkte nicht aktiviert, in dem man mit der Maus ber das entsprechende Feld bewegt, sondern man mu zus tzlich die linke Maustaste dr cken, um den Punkt anzuw hlen. Das gilt auch f r Untermen s: erst durch Klick auf den punkt, der noch weitere Unterpunkte enth lt, werden diese sichtbar. Das hat den grossen Vorteil, da man nicht st ndig versehentlich falsche s aufklappt, nur weil man die Maus versehentlich um ein paar Pixel falsch bewegt hat. Bei einigen Programmen sind die Men s derart verschachtelt, da eine Bedienung auf die herk mmliche Art zum Geduldspiel werden kann. Mit SELECT kann man die Men s dagegen wie eine ganz normale Knopfleiste bedienen. Klickt man einen Men punkt an, der keine weiteren Unterpunkte enth lt, so wird der entsprechende Punkt ausgew hlt und an das zust ndige Programm mitgeteilt. Um einen Men punkt auszuw hlen ohne das Men zu verlassen, mu die linke Maustaste zusammen mit der Shift-Taste bet tigt werden. @{" TOOL TYPE " Link ConfToolTypes}: f r @{" Pull-Down Men s " Link ConfPDBasic}: PD_BUTTONMODE=SELECT f r @{" Pop-Up Men s " Link ConfPUBasic}: PU_BUTTONMODE=SELECT Andere Bedienungsarten: @{" Standard " Link ConfStandard} @{" Press Once " Link ConfPressOnce} @endnode @Node "Conf3D-Look" 3.2.4 / 3.3.4 3D-LOOK Darstellung ********************************* Mit der neuen Betriebssystemversion 2.0 hat Commodore ein neues, dreidimensional wirkendes Outfit f r die Oberfl che des Amigas eingef Magic Menu bildet dieses auch f r die Men s nach. Das hei t, die Men boxen, selektierten Men punkte und Symbole scheinen aus dem restlichen Bild hervorzuragen oder wirken wie eingedr Das ist nicht nur optisch sch ner, sondern im Normalfall auch bersichtlicher. Auch zwei funkionelle Unterschiede der Darstellung ergeben sich daraus: - Intuition hebt einen Men punkt nur dann hervor, wenn dieser nicht "disabled", also mit Geisterschrift dargestellt, ist. Magic Menu verh sich hnlich, nur werden um ausgeschaltete Men punkte trotzdem mit einer Art "Geisterrahmen" versehen, nicht zuletzt um dadurch die @{" Tastaturbedienung " Link ConfKCBasic} zu erleichtern. - Neben den normalen Men punkten, die irgend eine Funktion ausl sen, gibt es auch solche, die eine Option ein- oder ausschalten. Optisch sind diese Punkte mit einem Haken versehen (wenn die Option eingeschaltet ist). F diese verwendet Magic Menu ebenfalls einen (nat rlich optisch aufgebesserten) Haken. Es gibt allerdings noch andere Men punkte, die von Intuition ebenfalls nur mit einem Haken versehen werden, eigentlich aber ganz anders funktionieren: Sogenannte "Multual Exclude" (=sich gegenseitig ausschliessende) Men s. Z.B. eine Auswahl f r die Hintergrundfarbe mit den Option "Rot", "Gr n", "Weiss". Davon kann immer nur ein Punkt aktiv sein. Magic Menu stellt diese Punkte wie ein Multual-Exclude-Gadget der OS 2.0 Oberfl che dar: die nicht aktiven Men punkte bekommen ein Bild das einen herausragenden Knopf symbolisieren soll, der aktive Punkt einen eingedr ckten, ausgef llten Knopf. Damit k nnen diese Men punkte auch optisch von den anderen unterschieden werden. Voraussetzung f r den 3D-Look ist allerdings, da der entsprechende Screen mehr als 2 Farben hat und auf eine 2.0 kompatible Weise ge ffnet wurde. gerade ltere Programme, die f r 1.3 geschrieben wurden, k nnen so diese Darstellung nicht bieten. Es gibt aber Programme (z.B. TagScreens von Martin Berndt) die daf r sorgen, alle Screens den 3D-Look bekommen. Aber hier ist Vorsicht geboten, da dabei oft die Farbauswahl nicht stimmt, und die Men s deshalb nicht mehr besonders dreidimensional aussehen. Dann sollte doch besser die @{" Standarddarstellung " Link ConfStandard-Look} gew hlt werden. Um zwischen der Standarddarstellung und der 3D-Darstellung umzuschalten, kann jederzeit, w hrend das Men angezeigt wird, die Ctrl-Taste gedr ckt werden. Bei wenigen Programmen, speziell solchen, die Farbauswahlmen s verwenden, kann es bei der 3D-Darstellung Probleme geben, siehe dazu bitte die @{" Problemecke " Link Problems} @{" TOOL TYPE " Link ConfToolTypes}: f r @{" Pull-Down Men s " Link ConfPDBasic}: PD_LOOK=3D f r @{" Pop-Up Men s " Link ConfPUBasic}: PU_LOOK=3D @endnode @Node "ConfStandard-Look" 3.2.5 / 3.3.5 STANDARD-LOOK Darstellung *************************************** Wer - warum auch immer - auf die @{" dreidimensionale Darstellung " Link Conf3D-Look} der Men verzichten will, kann auf die gewohnte Anzeige umschalten, in der die Men genau wie von Intuition angezeigt werden. Alle Vorteile von Magic Menu k nnen dann weiterhin verwendet werden. Die Darstellung wurde so exakt wie m glich nachgebildet, es gibt nur einen winzigen Unterschied zu den orignal Intuition-Men Wenn das Men ber die Tastatur bedient wird, werden auch "disabled" punkte (= ausgeschaltete, also in Geisterschrift dargestellte Men punkte) hervorgehoben. Das ist notwendig, da man sich sonst nicht orientieren kann. Wenn ein Screen nur 2 Farben hat, oder auf die alte Kickstart 1.3 kompatible Weise ge ffnet wurde, so wird automatisch die Standarddarstellung gew @{" TOOL TYPE " Link ConfToolTypes}: f r @{" Pull-Down Men s " Link ConfPDBasic}: PD_LOOK=2D f r @{" Pop-Up Men s " Link ConfPUBasic}: PU_LOOK=2D @endnode @Node "ConfCenter" 3.3.6 CENTER BOXES ****************** Diese Einstellung ist nur bei @{" Pop-Up Men s " Link ConfPUBasic} wirksam, bei @{" Pull-Down " Link ConfPDBasic} Men hat sie keinerlei Auswirkung. Wenn ein Men punkt noch weitere Unterpunkte besitzt, so wird dieses Untermen normalerweise rechts oder links unterhalb dieses Men punktes plaziert. Wo es genau hinkommt, bestimmt letztendlich der Programmierer, der die Men erstellt hat. Mit der Einstellung CENTER BOXES wird diese fixe Plazierung ignoriert, und statt dessen eine m glichst effiziente gew Wurde der entsprechende Men punkt noch nie vorher angew hlt, so wird das Untermen vertikal um den Men punkt zentriert. Zur Verdeutlichung eine kleine grafische Darstellung: Beispiel ohne CENTER BOXES: --------- | Project | | | | Edit | | ------- ----------- ||Options| Tabs | | -------| | | Texts | Pathes | --------| | | Colors | | -------- ---- ||Height | 10 | | --------| | | Width | 12 | | | | | Depth | 15 | --------- ---- Beispiel mit CENTER BOXES: ----------- --------| Tabs | | Project| | | | Pathes | | Edit | ---- | -------| Colors | 10 | ||Options| --------| | | -------||Height | 12 | | Texts | --------| | --------| Width | 15 | | ---- | Depth | ----------- Ein wenig anders l uft es, wenn bereits fr her ein Punkt aus dem Untermen ausgew hlt wurde: dann n mlich wird die Box so zentriert, da der zuletzt ausgew hlte Men punkt m glichst nah an der Maus liegt. @{" TOOL TYPE " Link ConfToolTypes}: f r @{" Pop-Up Men s " Link ConfPUBasic}: PU_CENTER=YES oder PU_CENTER=NO @endnode @Node "ConfKCBasic" 3.4 Tastatursteuerung ********************* Eine der ganz grossen Vorteile von Magic Menu ist, da die Maus eigentlich in ihrem H uschen bleiben kann, da die Men s vollst ndig ber die Tastatur bedienbar sind, auch wenn ein Men punkt ber keine Schnellwahl (Amigataste + Buchstabe) verf Wird das Men ber die Tastatur aktiviert (entweder ber die Tastenkombination + oder ber die Tastenkombination, die ber @{" START SEQUENCE " Link ConfKCStart} eingestellt wurde), so werden die Men punkte in der Screenleiste am oberen Bildschirmrand angezeigt. Bei der Tastatursteuerung wird immer die @{" Pull-Down Men " Link ConfPDBasic} Darstellung verwendet. In der Men leiste ist ein Men punkt hervorgehoben. Wenn das Men zum ersten mal aktiviert wurde, ist das immer der Punkt am linken Rand, sonst der zuletzt verwendete. Mit den Cursortasten kann zwischen den Men s gew werden, Return zeigt ein Untermen an, oder - wenn es keine mehr gibt - w den entsprechenden Men punkt aus. Mit der ESC-Taste kommt man wieder eine Ebene zur ck (aus dem Untermen in das vorhergehende). Dr ckt man ESC hrend nur noch die Titelzeile des Men s angezeigt wird, so wird das Men ohne Auswahl abgebrochen. Die bequemste Art zu einem bestimmten Men punkt zu gelangen, ist die Buchstabenwahl, dabei mu nur der Anfangsbuchstabe des gew nschten Punktes ckt werden, und damit ist dieser schon ausgew hlt. Gibt es mehrere punkte mit dem selben Anfangsbuchstaben, so wird zun chst der chstliegende hervorgehoben. Ein zweiter Druck auf den selben Buchstaben hebt dann denn n chsten Punkt hervor, und so weiter. Der gew nschten Punkt dann mit der Returntaste ausgew hlt werden. Um einen Men punkt auszuw hlen ohne das Men zu verlassen, mu die Returntaste zusammen mit der Shift-Taste bet tigt werden. Die Men auswahl kann jederzeit durch erneuten Druck der Aktivierungssequenz (siehe oben) abgebrochen werden. Wie man schnell bemerkt, denkt Magic Menu mit, und hebt immer den zuletzt aktiven Men punkt hervor, wenn ein (Unter-)men erneut angezeigt wird. Folgende Einstellungsm glichkeiten gibt es f r die Tastatursteuerung: @{" ENABLE " Link ConfKCEnable} @{" MOUSE TO BAR " Link ConfMouseToBar} @{" START SEQUENCE " Link ConfKCStart} Diese Einstellungen werden im rechten Bereich des @{" Einstellungsfensters " Link ConfBasic} festgelegt. Eine genaue Beschreibung der Taste befindet sich im Kapitel @{" Tastaturbelegung " Link CtrlKeys} @endnode @Node "ConfKCEnable" 3.4.1 ENABLE (Keyboard control) ******************************* Wenn dieser Schalter markiert ist, kann das Men auch ber die Tastatur gesteuert werden. Siehe dazu die folgenden Kapitel: @{" Tastatursteuerung " Link ConfKCBasic} @{" Tastaturbelegung " Link CtrlKeys} @endnode @Node "ConfMouseToBar" 3.4.2 MOUSE TO BAR ****************** Manche Programme (DPaint, Directory Opus u.a.) lassen eine Men auswahl nur dann zu, wenn sich die Maus in der Titelzeile des Screens befindet, da die rechte Maustaste sonst eine andere Funktion hat. Da dadurch auch die @{" Men auswahl per Tastatur " Link ConfKCBasic} verhindert wird, wenn sich die Maus zu weit unten befindet, hat Magic Menu die M glichkeit vor der Aktivierung des Men s die Maus in das obere linke Eck des Screens zu bewegen. Mit Hilfe des Schalters MOUSE TO BAR kann diese Funktion eingeschaltet werden. Normalerweise hat das keine negativen Seiteneffekte, so da diese Option eigentlich immer eingeschaltet bleiben kann. here Informationen dazu siehe bitte das Kapitel @{" Infos f r Programmierer " Link Profi} @endnode @Node "ConfKCStart" 3.4.3 START SEQUENCE ******************** In diesem Eingabefeld wird angegeben, mit welcher Tastenkombination die @{" tastengesteuerte Men auswahl " Link ConfKCBasic} aktiviert werden kann. Dabei werden die selben Tastenbezeichnungen verwendet, die auch alle anderen Commodity-Programme kennen, siehe dazu das Amiga Anwender Handbuch. Hier eine Aufstellung ber alle Codes, die von Amiga OS 2.04 (37.175) erkannt werden (sp tere Versionen kennen auch noch andere Bezeichnungen): lshift space rshift backspace capslock tab control enter lalt return ralt esc lcommand del rcommand up numericpad down shift right alt left caps f1 - f10 help so bedeutet z.B. die Eingabe "lcommand space", da die linke Amiga-Taste (=lcommand) und die Leertaste (=space) bet tigt werden mu Wird eine fehlerhafte Kombination eingegeben, so meldet das Magic Menu, und die alte Einstellung bleibt aktiv. Die Tastenkombination "ralt rcommand" (also die rechte Alt und Amiga Taste zusammen) funktioniert immer, unabh ngig welche Start Sequenz eingegeben wird (es sei denn, @{" ENABLE " Link ConfKCEnable} ist nicht angew hlt). @endnode @Node "ConfType" 3.5.1 TYPE (grosses Cycle Gadget) ********************************* ber diesen Wahlschalter kann ausge hlt werden, ob @{" Pull-Down " Link ConfPDBasic} oder @{" Pop-Up " Link ConfPUBasic} s verwendet werden: USE PULL DOWN MENU ONLY Ist diese Einstellung aktiv, so wird generell nur das Pull-Down Men verwendet. USE POP UP MENU ONLY Bei dieser Einstellung wird immer das Pop-Up Men verwendet, auch wenn die Maus bereits in der Titelzeile ist. Einzige Ausnahme: Die @{" Tastatursteuerung " Link ConfKCBasic} greift auch hier auf das Pull-Down Men USE PULL DOWN WHEN POINTER IN MENUBAR, POP UP OTHERWISE: Der "Automatik-Mode", wenn die Maus in der Titelzeile ist, wird das Pull-Down Men verwendet, sonst das Pop-Up. Das ist deswegen recht praktisch, da man (als Gewohnheitstier) oft mit der Maus an den oberen Bildrand geht, bevor man die rechte Maustaste dr ckt. Dann sollte aber auch das erwartete Pull-Down Men erscheinen, und der Anwender nicht von dem Pop-Up Kasten berascht werden. @{" TOOL TYPE " Link ConfToolTypes}: f r "USE PULL DOWN MENU ONLY": MENUTYPE=PULLDOWN f r "USE POP UP MENU ONLY": MENUTYPE=POPUP f r "USE PULL DOWN WHEN POINTER ...": MENUTYPE=AUTO @endnode @Node "ConfMarkSub" 3.5.2 MARK SUB MENUS ******************** Mit dieser Option kann eine Markierung f r Men punkte, die weitere Unterpunkte enthalten, aktiviert werden. Dabei wird am rechten Rand solcher Men punkte ein kleiner Pfeil nach rechts angezeigt. Ist allerdings der Text dieses Punktes zu lang, oder verwendet das Programm eine eigene Markierung (z.B. alle Programme, die ihre Men s mit Hilfe der GadTools.library aufbauen), dann wird die Markierung von Magic Menu unterdr @{" TOOL TYPE " Link ConfToolTypes}: MARKSUB=YES oder MARKSUB=NO @endnode @Node "ConfDBorder" 3.5.3 DOUBLE BORDERS ******************** Normalerweise erscheinen alle Men s von Magic Menu so, als ob sie etwas aus dem Bildschirm herausragen w rden, hervorgehobene Men punkte erscheinen etwas nach hinten vesetzt. Ausserdem ergibt sich bei den Pull-Down Men s eine Art "Karteikarteneffekt". Wenn diese Option aktiv ist, wird stattdessen ein Rahmen um die Men gezeichnet, hervorgehobene Men punte scheinen etwas herauszuragen. Der Unterschied ist rein optisch, am besten probiert man beide Varianten aus und bleibt dann bei der, die besser gef Im @{" Standard-Look " Link ConfStandard-Look} hat diese Option keine Wirkung. @{" TOOL TYPE " Link ConfToolTypes}: DOUBLEBORDER=YES oder DOUBLEBORDER=NO @endnode @Node "ConfTimeout" 3.5.4 MENU TIMEOUT ****************** Hier kann die Zeit (in Sekunden) eingestellt werden, nach der die Men auswahl automatisch abgebrochen wird, wenn keine Bedienung (Mausbewegung, Tastendruck...) mehr erfolgt ist. nnen Werte zwischen 1 und 120 Sekunden eingegeben werden. Da Magic Menu - genau wie die normalen Intuition Men s - den Screen, auf dem die Men s angezeigt werden, einfriert, wird somit eine l ngere Blockierung der Programme vermieden. Ausserdem kann es in seltenen F llen dazu kommen, da sich Magic Menu und Intuition gegenseitig in die Quere kommen, z.B. wenn ein Fenster verschoben werden soll, w hrend ein Men angezeigt wird. (Da der Anwender selbst kein Fenster verschieben kann, w hrend ein Men angezeigt wird, ist das fast schon ausgeschlossen.) In einem solchen Falle bleibt der Mauszeiger stecken, und der Amiga nimmt keine Eingaben mehr an. Eine solche Situation nennt man einen "Deadlock". Nach der eingestellten Timeout Zeit befreit Magic Menu den Amiga allerdings automatisch aus diesem Deadlock. Siehe auch die folgenden Kapitel: @{" Problemecke " Link Problems} @{" Infos f r Programmierer " Link Profi} @{" TOOL TYPE " Link ConfToolTypes}: TIMEOUT= @endnode @Node "ConfHide" 3.5.5 HIDE ********** Dieser Knopf l t das @{" Einstellungsfenster " Link ConfBasic} verschwinden, Magic Menu bleibt aber witer aktiv. Statt HIDE kann auch das Close Gadget des Fensters angeklickt werden. @endnode @Node "ConfSave" 3.5.6 SAVE ********** Die aktuellen Einstellungen von Magic Menu werden fest gespeichert und sind somit auch beim n chsten Programmstart wieder aktiv. Magic Menu speichert seine Einstellungen im Icon ab, von dem aus es gestartet wurde (wenn Magic Menu aus dem CLI gestartet wurde, so wird gegebenfalls ein Icon angelegt). @endnode @Node "ConfQuit" 3.5.7 QUIT ********** Wenn auf diesen Knopf gedr ckt wird, versucht Magic Menu sich selbst aus dem System zu entfernen. Das mu nicht immer funktionieren, siehe dazu auch die Kapitel @{" Magic Menu beenden " Link Removing} @{" Infos f r Programmierer " Link Profi} @endnode @Node "ConfToolTypes" 3.6 Tool Types ************** Magic Menu wird vollst ding ber die Tool Types der Workbench gesteuert. Hier eine kurze Erkl rung, wie diese Tool Types ge ndert werden k nnen. Eine detailiertere Beschreibung befindet sich im Amiga Anwender Handbuch. 1. Mit der Maus das Icon von Magic Menu einmal anklicken 2. aus dem Men "Icons" (deutsch "Piktogramm") den Punkt "Info" (deutsch "Informationen") anw hlen. Es ffnet sich ein Fenster mit allerlei interessanten Details zu der Datei MagicMenu. 3. Aus der unten angezeigten Liste den gew nschten Tool Type ausw hlen. Eventuell mu mit dem Scrollbalken und den Pfeilen rechts die Liste nach oben gescrollt werden. Ist der gew nschte Tool Type nicht in der Liste, so mu er neu erstellt werden, dazu auf "NEW" (deutsch "NEU") dr cken. 4. In dem Eingabefeld den gew nschten Wert in der Form = eingeben. Die Schritte 3 und 4 f r alle gew nschten Tool Types wiederholen. 5. Zum Abspeichern der nderungen auf "SAVE" (deutsch "Speichern") dr cken. @endnode @Node "ConfSmartPatch" 3.6.1 SMARTPATCH **************** Bevor sich Magic Menu aus dem System entfernt, berpr ft es zuerst alle gepatchten Vektoren, ob sich nach Magic Menu ein weiteres Programm in die gleichen Systemroutinen eingeh ngt hat. Im Normalfall kann Magic Menu in einem solchen Fall nicht entfernt werden. Es gibt Programme, die generell das Patchen von Systemroutinen berwachen und so gef hrliche Situationen, die durch das Patchen entstehen k nnen, vermeiden helfen. Ist ein solches Programm (z.B. SaferPatches von Martin Adrian) aktiv, so erkennt Magic Menu f lschlicherweise, da die Routinen weiter verbogen worden sind. Die Meldung kann dann getrost ignoriert werden indem man auf "Force uninstall" klickt. Um den Sicherheitstest von Magic Menu ganz auszuschalten kann auch die Option SMARTPATCH auf NO gesetzt werden. @{" TOOL TYPE " Link ConfToolTypes}: SMARTPATCH=YES oder SMARTPATCH=NO (Default: YES) Siehe dazu auch das Kapitel @{" Magic Menu beenden " Link Removing} @endnode @Node "ConfCheckWB" 3.6.2 CHECKWB ************* Unter Kickstart 2.04 ndert die Workbench die Men s sehr h ufig mit der Funktion SetMenuStrip(), z.B. beim Anklicken eines Fensters oder eines Icons. Das ist unn tig und kostet viel Rechenzeit, es k nnte genausogut ResetMenuStrip() verwendet werden. Damit trotz dieses Fehlers (der in KS 3.0 behoben ist) Magic Menu sinnvoll eingesetzt werden kann, ist Magic Menu in der Lage, wiederholtes Aufrufen von SetMenuStrip() von der Workbench f r ein und das selbe Fenster zu erkennen und abzufangen. Diese Option sollte also IMMER auf YES stehen, es sei denn, es treten unerwartete Kompilkationen mit den Workbench Men s auf. Auf andere Men s hat dieses Flag keinerlei Auswirkungen. @{" TOOL TYPE " Link ConfToolTypes}: CHECKWB=YES oder CHECKWB=NO (Default: YES) Siehe dazu auch das Kapitel @{" Infos f r Programmierer " Link Profi} @endnode @Node "ConfUseLayer" 3.6.3 USELAYER ************** Magic Menu zeichnet normalerweise alle Men s in sogenannten "Layers", d.h. das Betriebssystem sorgt daf r, da beim erstellen der Men s nicht ber den reervierten Bereich hinausgemalt wird, auch wenn ein Men nicht korrekt aufgebaut ist. Diese Layer verlangsamen allerdings den Aufbau der Men s deutlich, besonders Amiga User mit einem 68000er Prozessor werden das merken. Deswegen kann mit Hilfe dieses Tool Types dieses Verhalten abgeschaltet werden, Magic Menu zeichnet die Men s dann unter Umgehung der layers.library. @{" TOOL TYPE " Link ConfToolTypes}: USELAYER=YES oder USELAYER=NO (Default: YES) @endnode @Node "ConfKCRAltRCommand" 3.6.4 KC_RALTRCOMMAND ********************* Neben der eingestellten Tastensequenz fuer die Tastensteuerung akzeptiert Magic Menu auch immer die Kombination RAlt + RCommand, genau wie Intuition selbst. Mit diesem Tool Type kann man dieses Verhalten abschalten. @{" TOOL TYPE " Link ConfToolTypes}: KC_RALTRCOMMAND=YES oder KC_RALTRCOMMAND=NO (Default: YES) @endnode @Node "ConfCXPrio" 3.6.5 CX_PRIORITY ***************** Diese Option gibt die Priorit t (Reihenfolge, in der die Ereignisse bearbeitet werden) von Magic Menu in der Commodity-Handler Kette an. Im Normalfall sollte das 0 sein. @{" TOOL TYPE " Link ConfToolTypes}: CX_PRIORITY= (Default: 0) @endnode @Node "ConfCXPopUp" 3.6.6 CX_POPUP ************** Steht diese Option auf YES, dann wird das @{" Einstellungsfenster " Link ConfBasic} von Magic Menu sofort nach dem Programmstart ge ffnet. Wird Magic Menu bei jedem Systemstart aufgerufen ( ber WBStartup oder der User-Startup), dann sollte diese Option ausgeschaltet werden. @{" TOOL TYPE " Link ConfToolTypes}: CX_POPUP=YES oder CX_POPUP=NO (Default: YES) @endnode @Node "ConfCXPopKey" 3.6.7 CX_POPKEY *************** In diesem Tool Type wird angegeben, welche Tastensequenz das @{" Einstellungsfenster " Link ConfBasic} von Magic Menu ffnet. Normalerweise ist das "control alt space", es kann aber auf jeden beliebigen anderen Wert gesetzt werden. @{" TOOL TYPE " Link ConfToolTypes}: CX_POPKEY= (Default: control alt space) @endnode @Node "ConfDontWait" 3.6.8 DONOTWAIT *************** Diese Option MUSS angegeben werden, wenn Magic Menu in der WBStartup Schublade aufgerufen werden soll, da die Workbench sonst vergeblich darauf wartet, da Magic Menu fertig wird. @{" TOOL TYPE " Link ConfToolTypes}: DONOTWAIT @endnode @Node "ConfToolPri" 3.6.9 TOOLPRI ************* Die Workbench teilt jedem gestarteten Programm eine Priorit t zu, die diesen Tool Type festgelegt werden kann. Normalerweise ist das die Priorit Magic Menu sollte allerdings auf einen h heren Wert eingestellt zu werden, damit die Darstellung der Men s nicht durch ein rechenintensives Programm gebremst wird. Empfehlenswert ist der Wert 5, den auch die Intuition selbst verwendet. @{" TOOL TYPE " Link ConfToolTypes}: TOOLPRI= (Default: 0) @endnode @Node "ConfStartPri" 3.6.10 STARTPRI *************** Dieser Tool Type hat nur bei Programmen in der WBStartup Schublade Bedeutung. Er gibt an, in welcher Reihenfolge die Programme gestartet werden sollen. Da das in der Regel keine Rolle spielt, kann dieser Wert normalerweise auf 0 stehen. Eine Ausnahme stellen Programme dar, die die Workbenchmen s modifizieren, diese M SSEN nach Magic Menu gestartet werden. @{" TOOL TYPE " Link ConfToolTypes}: STARTPRI= (Default: 0) @endnode @Node "Hotkeys" 4.1 Hotkeys *********** Hotkeys sind Tastenkombinationen, die jederzeit eine bestimmte Aktion MagicMenu verwendet drei Hotkeys: Zeigt das @{" Einstellungsfenster " Link ConfBasic} an. Dieser Hotkey kann ber den Tool Type CX_POPKEY modifiziert werden. Aktiviert die Men auswahl mit der @{" Tastensteuerung " Link ConfKCBasic}. Funktioniert nur, wenn die Tastensteuerung aktiviert ist. Dieser Hotkey kann die Option @{" START SEQUENCE " Link ConfKCStart} modifiziert werden. Aktiviert ebenfalls die Men auswahl mit der Tastensteuerung. Dieser Hotkey wurde eingebaut, um mit Intuition kompatibel zu bleiben. Er kann nicht modifiziert werden. @endnode @Node "CtrlKeys" 4.2.1 Tastaturbelegung in allen Modi ************************************ Die folgenden Tasten funktionieren immer, wenn das Men angezeigt wird, unabh ngig von der gew hlten @{" Bedienungsart " Link ConfStandard}. Bricht das Men ab, ohne eine Auswahl getroffen zu haben. Bei der Tastursteuerung wird nur das zuletzt ge ffnete Untermen geschlossen, um das Men ganz zu verlassen mu also evtl. bis zu drei mal gedr ckt werden. (w hrend das Men angezeigt wird) Schaltet zwischen der 3D- und der Standarddarstellung um. Sinnvoll, wenn bei einem Men die Farben nicht korrekt angezeigt werden. (dr cken und halten BEVOR die Men auswahl aktiviert wird) Wenn ein Men nicht mit Magic Menu zusammenarbeitet, kann auf diese Weise auf die original Intuition Men s zur ckgegriffen werden. Allerding mu dann auf alle Vorteile von Magic Menu verzichtet werden. @{" Hotkey " Link Hotkeys} zum Aktivieren der Tastensteuerung Wird einer der beiden Aktivierungs-Hotkeys gedr ckt, so wird die Men auswahl immer abgebrochen. Siehe auch das Kapitel @{" Tastaturbelegung f r die Tastensteuerung " Link KCKeys} @endnode @Node "KCKeys" 4.2.2 Tastaturbelegung f r die Tastensteuerung ********************************************** Die folgenden Tasten funktionieren nur, wenn die Men auswahl ber einen der @{" Tastaturhotkeys " Link Hotkeys} gestartet wurde. ffnet ein (Unter-)Men oder w hlt einen Men punkt an. Zusammen mit der Shift Taste k nnen mehrere Men punkte angew hlt werden. Der letzte Men punkt mu aber immer OHNE Shift gedr ckt werden! und W hlt einen Hauptmen punkt aus. Mit Shift zusammen kommt man ganz nach rechts bzw. links. und W hlt einen (Unter-)Men punkt aus. Mit Shift zusammen kommt man ganz nach oben bzw. unten. Buchstaben- oder Zifferntaste Der n chste (Unter-)Men punkt, der mit der gedr ckten Taste beginnt, wird ausgew hlt. Ist dieser Men punkt der einzige, der mit diesem Buchstaben anf ngt, wird der Punkt automatisch aktiviert (je nach Punkt also das Untermen ge ffnet oder das Men mit der entsprechenden Auswahl beendet). Siehe auch das Kapitel @{" Tastatursteuerung " Link ConfKCBasic} @endnode @Node "Questions" 5.1 Fragen und Antworten ************************ F: "Immer, wenn ich das Men aktiviere, bleibt alles stehen. Warum?" A: Magic Menu mu - genau wie Intuition selbst - den Screen, auf dem das Men angezeigt wird, sperren. Das hei t, kein Programm kann mehr auf diesem Screen eine Ausgabe machen. Die Ausgabe auf anderen Screens wird nicht blockiert, mit einer Ausnahme: Fenster k nnen nicht ge ffnet werden (die Programme, die ein Fenster ffnen wollen, m warten, bis die Men auswahl abgeschlossen ist). F: "Mein Programm l uft auf einem anderen Screen, trotzdem wird es angehalten! Warum?" A: Eventuell macht das Programm Ausgaben in das CLI (das sich in der Regel auf der Workbench befindet) und wird angehalten, wenn auf der Workbench ein Men ffnet wird. Das passiert auch ohne Magic Menu. Eine andere M glichkeit ist, da das Programm versucht, ein Fenster zu ffnen. F: "Bei einigen Programmen hat das Men recht seltsame Farben. Warum?" A: Wenn ein Screen mit den 2.0 "Tags" ge ffnet wird, dann hat dieser Screen die richtigen Farben mitbekommen. Alle andere Screens (die 1.3 kompatibel ge ffnet werden) werden normalerweise in der Standarddarstellung (wie unter Intuition) angezeigt. Programme wie "TagScreens" k nnen num auch bei "herk mmlichen" Screens den 3D-Look einf hren, allerdings stimmen dann die Farben nicht immer. Im Notfall kann immer mit der CTRL-Taste auf die Standarddarstellung umgeschaltet werden, ohne da auf die Vorz ge von Magic Menu verzichtet werden muss. F: "Bei Farbauswahlmen s bekomme ich falsche Farben. Wie kann ich das ndern? A: Wenn das Men dargestellt wird, einfach die CTRL-Taste dr cken. Siehe auch die Kapitel @{" Problemecke " Link Problems} @{" Infos f r Programmierer " Link Profi} @endnode @Node "Problems" 5.2 Problemecke (Bekannte Fehler) ********************************* Leider lassen sich einige Probleme nicht ganz vermeiden, damit niemand berrascht wird, hier eine Aufstellung ber alle bekannten Schwierigkeiten: o Bei allen Fensteroperationen ausser OpenWindow(), OpenWindowTagList() und ActivateWindow() kann es zu einem Deadlock kommen, wenn gerade das Men aktiv ist. Dieser Deadlock wird aber durch den Timeout abgefangen. o Um die Men s im OS 2.0-Look anzuzeigen, m ssen Textfarbe und Hintergrundfarbe vertauscht werden. Ich habe versucht, da intelligent wie m glich zu machen. Trotzdem kann es passieren, da einigen Men s die Farben falsch angezeigt werden, und Verwirrung entsteht. Z.B. wird bei Farbauswahlmen s oft Farbe 0 als Farbe 1 angezeigt (alle anderen Farben werden korrekt angezeigt). Wenn f r ein Men die Darstellung von Magic Menu absolut nicht verwendbar ist, kann die rechte Maustaste zusammen mit der Ctrl-Taste gedr ckt werden, dann wird wieder das original Intuition Men verwendet. Auch w hrend ein Men angezeigt wird, kann mit der Ctrl Taste auf den Standard-Look umgeschaltet werden, der alle Farben korrekt wiedergibt. o Unter Kickstart 3.0 ist ein neues Ph nomen aufgetaucht. Magic Menu wertet die Informationen der neuen DrawPen Struktur aus, in der die Farben f r die Men ber das Prefs Programm "Palette") eingestellt werden. In der Standarddarstellung verwendet Magic Menu diese Farben. Es scheint aber einige Programme zu geben (Superbase, Euromail), die diese Struktur falsch belegen, und somit Magic Menu ziemlich verwirren. Bei diesen Programmen kann es deswegen vorkommen, da in der STANDARDdarstellung falsche Farben verwendet werden, dann sollte mit der Ctrl-Taste auf die 3D-Darstellung umgeschaltet werden. Siehe auch die Kapitel @{" Fragen & Antworten " Link Questions} @{" Infos f r Programmierer " Link Profi} @endnode @Node "Profi" 5.3 Informationen f r Programmierer *********************************** Ich habe versucht, Magic Menu so kompatibel wie m glich zu halten, d.h. da das Verhalten von Intuition so gut wie m glich nachgebildet wird. Also: o Bei der Darstellung der Men s wird der entsprechende Screen gelockt, die Darstellung der Men s geschieht unsichtbar im Hintergrund und wird dann mit der Routine SwapBitsRastPortClipRect() der layers.library komplett in den Schirm kopiert. Dadurch funktioniert Magic Menu auch mit den diversen Grafikkarten Hacks, wie der Domino oder Omnibus. o Damit nicht durch einen Programmfehler oder illegal aufgebaute Men Speicherbereiche berschrieben werden k nnen, werden die Men s in Layers gezeichnet, die alle Zeichenoperationen automatisch am Rand clippen. o Bevor Magic Menu ein Men aufbaut, wird an alle Fenster, die IDCMP_MENUVERIFY gesetzt haben, eine entsprechende Nachricht gesendet. Das aktuelle Fenster kann die Men auswahl ber MENUCANCEL unterbinden. o Magic Menu sendet Menuevents mit dem Kommando IND_WRITEEVENT des input.device ber die Input-Handler Kette. Intuition schickt dann eine entsprechende IDCMP-Message an das aktive Fenster. Auch Programme, die das Men ber Input-Handler oder das console.device abfragen, bekommen so Nachricht. o IDCMP_MENUHELP wird unterst tzt. Getestet habe ich das mit Kai Iskes KCommodity, dem einzigen mir bekannten Programm, das dieses Feature nutzt. o Die Funktionen OpenWindow(), OpenWindowTagList(), ClearMenuStrip(), SetMenuStrip(), ResetMenuStrip() und ActivateWindow() wurden gepatcht, so da sie erst zur Ausf hrung kommen, wenn die Men operation abgeschlossen ist, um Deadlocks oder Abst rze zu vermeiden. o Programmierer, die Men r ihre Programme erstellen, sollten darauf achten, die korrekten Werte f r das Feld MenuItem->FLAGS zu verwenden. So mu z.B. ein Text, der nicht angew hlt werden kann, oder eine Trennlinie das Flag HIGHNONE ($00c0) erhalten, und nicht - wie bei einigen Programmen scheinbar blich - HIGHIMAGE ($0000). Durch diesen Fehler kann die Tastatursteuerung f r den Anwender etwas verwirrend werden. Siehe auch die Kapitel @{" Fragen & Antworten " Link Questions} @{" Problemecke " Link Problems} @endnode @Node "History" 6.1 Entwicklung (History) ************************* Um zu erfahren, was sich in den einzelnen Versionen von Magic Menu ge ndert hat, kann man die folgenden Kapitel lesen. Anwender, die bereits eine ltere Version von Magic Menu installiert hatten, sollten unbedingt lesen, was sich seit dem ge ndert hat. Wer einfach wissen m chte, mit welchen Problemen ich zu k mpfen hatte, kann sich die History auch durchlesen. Zu beachten ist dabei, da die Aufstellung chronologisch verkehrt herum ist (die j ngsten nderungen ganz oben, die ltesten ganz unten). @{" Version 1.29 " Link Hist129} @{" Version 1.27 " Link Hist127} @{" Version 1.22 " Link Hist122} @{" Version 1.15 " Link Hist115} @{" Version 1.14 " Link Hist114} @{" Version 1.06 " Link Hist106} @{" Version 1.00 " Link Hist100} @{" Geplante Features f r kommende Versionen " Link Future} @endnode @Node "Hist129" Revision V1.29 -------------- changed on Tuesday, 23-Nov-93 22:33:00 Folgende Fehler wurden beseitigt: - Das Feld ie_Qualifier war bei allen von MM gesendeten Messages oder Events ungesetzt (= 0). Jetzt wird das Feld mit PeekQualifier() des input.device vorbesetzt. Damit funktionieren auch wieder die Programme, die dieses Feld bei Menu-Events auswerten (ADoc, GenAm...). (Hinweis von Denis Gounelle) Revision V1.28 -------------- changed on Wednesday, 06-Okt-93 23:24:00 by --- Unknown ---. LogMessage : Folgende Fehler wurden beseitigt: - Special Bug-Fix ganz speziell nur fuer Mr SIERRA@FUTURE.ZER! Die multual-exclude Menues werden jetzt, wie es auch sein sollte mit 32, und nicht wie bisher nur mit 16 Bits, ausgewertet. @endnode @Node "Hist127" Revision V1.27 -------------- changed on Sunday, 01-Aug-93 16:27:00 by --- Unknown ---. LogMessage : Folgende Fehler wurden beseitigt: - Das Verschieben der Menues, das in V 1.26 eingef hrt wurde, hat viele optische Probleme aufgeworfen und wurde deswegen wieder ent- fernt. Stattdessen verwendet MagicMenu nun schm lere Images, wenn die Standardimages nicht passen. - Bei Programmen, die eigene Checkimages verwenden, konnte es passieren, dass beim L schen dieser Images zuviel oder zu wenig gel scht wurde. Revision V1.26 -------------- changed on Saturday, 31-Jul-93 20:45:00 by Martin Kornd rfer. LogMessage : Folgende Fehler wurden beseitigt: - Menuitems mit der Gr e 0x0 Pixel konnten MagicMenu zum Absturz bringen. Solche (sinnlosen) Men s waren u.a. in TXEd und DOpus 4.1x enthalten. Der Workaround der Version 1.24 wird damit berfl ssig, DOpus funktioniert wieder korrekt mit MagicMenu. - Ein Multual Exclude Menuitem kann nun auch MENUTOGGLE gesetzt haben. Dadurch kann ein CHECKED Multual-Exclude Menu vollst ndig deselek- tiert werden. Dieses Verhalten ist zwar etwas unlogisch und ist so auch nicht dokumentiert, aber Intuition verh lt sich dementsprechend. - Bei Menues die bis ganz zum rechten Screenrand reichen, konnte MM das Menue am rechten Rand nicht mehr anzeigen. Das wurde behoben. Damit ist auch das Term 3.4 Men (Dial) wieder anw hlbar. - Das Checkmark wird nun wieder NACH allen Texten gezeichnet, dadurch werden alle Probleme durch bermalte Checkmarks behoben. - MagicMenu passt jetzt unter KS 3.x jedes Men automatisch an den verwendeten Checkmark an. Dadurch kann es nicht mehr vorkommen, dass sich Checkmark und Men texte berschneiden. Ausserdem sieht es optisch nun besser aus (Vorschlag von Martin Berndt). Revision V1.25 -------------- changed on Thursday, 24-Jul-93 19:51:00 by Martin Kornd rfer. LogMessage : Folgende Fehler wurden beseitigt: - In Release 1.24 wurden Fenster OHNE NewLookMenu falsch erkannt und die Menue demnach falsch dargestellt. Erg nzungen: - WindowToFront() wird nun auch gepatcht, so dass es keine Probleme mehr mit den diversen Programmen, die haeufig das Fenster nach vorne holen, geben sollte. - Die Maus wird nach der Tastaturbedienung nun immer wieder an die alte Position zurueckgestellt. (Vorschlag von Garry Glendown und anderen) - Neue Tool Types: o USELAYER (Default: YES): wenn aktiviert, verwendet MagicMenu die layers.library um zu vermeiden dass Speicher durch illegal gestaltete Menues oder einen Bug in MM berschrieben werden kann. Dadurch wird MM aber ziemlich gebremmst, deswegen koennen besonders User auf 68000er Amigas auf dieses Feature verzichten. Bisher hat MM immer die layers.library ben tzt. (Vorschlag von Martin Berndt) o KC_RALTRCOMMAND (Default: YES): Mit diesem Tool Type kann verhindert werden, dass MM die Tastenkombination RAlt - RCommand als Startsequenz fuer die Tastatursteuerung verwendet. Wenn dieses Tool Type auf NO gesetzt wird, kann nur noch die eingestellte Sequenz fuer die Tastatursteuerung verwendet werden. Eigentlich geh rt das in die Oberflaeche, ich bitte um Nachsicht dass ich das auf das naechste grosse Release verschiebe. (Vorschlag von Marc Jakisch) Revision V1.24 -------------- changed on Thursday, 22-Jul-93 22:50:00 by Martin Kornd rfer. LogMessage : Folgende Fehler wurden beseitigt: - CED 3.5 und andere Programme versuchten sich im OS 3.0 Menue-style und produzierten mit MagicMenu eine Bauchlandung. Nun werden diese Menues in 3D- und Standarddarstellung korrekt behandelt. (Hinweis von Garry Glendown) Ungel ste Probleme: - Directory Opus 4.10 bringt MagicMenu eiskalt zum Abst rzen. Die Ur- sache hierf r ist nicht offensichtlich und ist wahrscheinlich in einer etwas un blichen Behandlung der Mouse-Events durch DOpus zu suchen. Da ich im Moment keine Zeit f r eine ausf hrliche Fehler- suche habe, ist in dieser Version erst mal nur eine spezielle Ab- frage enthalten, die verhindert, dass bei DOpus MagicMenu aktiviert wird. Dadurch muss innerhalb von DOpus vorl ufig auf MagicMenu verzichtet werden. (Hinweis von vielen, Martin Berndt war wieder einmal der schnellste... ;)) Revision V1.23 -------------- changed on Tuesday, 18-Mai-93 22:09:51 by Martin Kornd rfer. LogMessage : (Revision 1.23 war kein Fake, sorry, ich hatte schlicht vergessen die Dokumentation auf den aktuellen Stand zu bringen...) Folgende Fehler wurden beseitigt: - Im 2D-Look wurden bei einigen Programmen die Menueeintraege geloescht, wenn man mit der Maus darueber faehrt. - Der Haken konnte bei einigen Programmen berdeckt werden. @endnode @Node "Hist122" Revision V1.22 -------------- changed on Wednesday, 24-Feb-93 13:42:39 by Martin Kornd rfer. LogMessage : Folgende Fehler wurden beseitigt: - Im Standard-Look wurden bei der Mehrfachselektierung die Checkmarks nicht korrekt upgedated. - Ebenfalls im Standard-Look wurden die Shortkeys zu weit rechts gezeichnet. - Im Pull-Down Men wurden die Hauptmen punkte zwei Pixel zu weit links gezeichnet. (Hinweis von Martin Huttenloher) nderungen: - Wenn das ToolType CHECKWB gesetzt ist, wird jetzt auch f r PageStream ein hnlicher Patch vorgenommen. Das ist nur eine Zwischenl sung, bis das Menu-Chaching fuer die Programme getrennt gesteuert werden kann. (Vorschlag von Martin Huttenloher) Revision V1.21 -------------- changed on Tuesday, 16-Feb-93 18:00:21 by Martin Kornd rfer. LogMessage : Folgende Fehler wurden beseitigt: - Wenn in einem Fenster ohne Menue die rechte Maustaste gedr ckt wurde, hat Magic Menu ein wenig Speicher verloren. (Hinweis von Paul Miranda und Peter Elzner). - Wenn RMBTRAP gesetzt war, wurden ZWEI Messages (MENUDOWN) generiert. - Der Font f r die Men leiste wurde nicht immer korrekt gesetzt. - MagicMenu behandelt jetzt Requester korrekt. D.h. wenn ein Requester in einem Fenster aktiv ist, kann kein Menue aktiviert werden. Ausserdem werden jetzt die Double-Menue-Requester korrekt unterstuetzt. (Es gibt TATSAECHLICH Programme, die dieses Feature nutzen...) (Hinweis von Gerhard Schmidt). - Zwei Enforcer-Hits beseitigt. nderungen: - Uebergrosse Screens werden bei der Tastatursteuerung jetzt richtig verschoben, so dass der aktuelle Menuepunkt immer sichtbar ist. - Der SELECT Modus wurde etwas flexibler: Man kann nun auch die rechte Maustaste gedrueckt halten bei der Auswahl. Laesst man die rechte Maustaste ausserhalb des Menues los, so wird die Auswahl abgebrochen, laesst man sie innerhalb des Menues los, so verhaelt sich MagicMenu wie gehabt. Somit verhalten sich die MagicMenus im Select-Mode aehnlich wie in Motif, OS/2 und W*ndows. Revision V1.20 -------------- Folgende Fehler wurden beseitigt: - Tja, auch in V 1.19 wurden die Amigakeys nicht immer richtig plaziert, diesmal waren die Submenus dran... Ich hab jetzt den Work-Around fuer Programme, die die Shortcuts nachtraeglich (nach SetMenuStrip()) in die Men struktur reinpatchen (siehe Revision 1.13) wieder rausgenommen, da es sonst doch etwas undurchsichtig wurde. Revision V1.19 -------------- changed on Donnerstag, 24-Dez-92 14:44:09 by Martin Kornd rfer. LogMessage : (Das Weihnachtsupdate ;-) ) Folgende Fehler wurden beseitigt: - Beim Abspeichern der Einstellungen wurden die Darstellung der Pull- Down- und Pop-Up Men s immer auf 3D umgestellt und auch so abge- speichert. Der Bug ist schon immer drin gewesen, ich hab die Bug- reports immer auf einen alten Fehler geschoben, sorry. - Wenn Menues mehrspaltig waren und die Punkte mit Shortcuts versehen waren, wurden die Amigakeys teilweise wild in der Zeile gezeichnet. Behoben (Hinweis von Candid B schen) Revision V1.18 -------------- changed on Montag, 21-Dez-92 21:31:31 by Martin Kornd rfer. LogMessage : Folgende Fehler wurden beseitigt: - ActivateWindow() funktionierte manchmal nicht mehr, wenn Magic Menu aktiv war. (Hinweis von unz hligen Anwendern) nderungen: - Das Checkmark (Haken oder MX-Image) wird jetzt VOR dem Menuetext gezeichnet, dadurch wird der Text bei Fonts kleiner Topaz 8 nicht mehr durch das Image ueberschrieben. Das ist eine Zwischenloesung, fuer die 3.0 NewLook-Menues, so lange Magic Menu die Images nicht skaliert. (Vorschlag von Martin Berndt) - Im Select-Modus kann ein bereits angew hlter Men punkt noch zur genommen werden, so lange die linke Maustaste gedr ckt bleibt, indem die Maus von dem Punkt wegbewegt wird. (Vorschlag von Michael Balzer) Revision V1.17 -------------- changed on Donnerstag, 11-Dez-92 18:57:00 by Martin Kornd rfer. LogMessage : Folgende Fehler wurden beseitigt: - Im 3D-Look konnte es vorkommen, da einige Men eintr ge gel wurden, wenn man sie hervorhob. Diese Men s hatten den COMPLEMENT DrawMode in der IntuiText-Struktur gesetzt. Dieses Flag wird im 3D-Look jetzt ignoriert. @endnode @Node "Hist115" Revision V1.15 -------------- changed on Mittwoch, 02-Dez-92 22:49:57 by Martin Kornd rfer. LogMessage : nderungen: - Umgestellt auf die neue SAS/C Version 6.0 / 6.1 - Selektierte Men punkte werden jetzt auch im 3D-Look invertiert. Disablete Men punkte werden im 3D-Look "geghosted" hervorgehoben, im Standardlook - wie bei Intuition - gar nicht, es sei denn, die Men s werden ber die Tastatur bedient, dann geht es nicht anders. - F r Toggle-Men punkte wird jetzt wieder ein Haken verwendet (der im 3D-Look nat rlich auch erhaben wirkt). Multual-Exclude Men werden weiterhin mit den bisherigen MX-Images markiert. - Kickstart 3.0 wird unterst tzt. Die skalierten Images und die neuen DrawPens werden im Standard-Look verwendet. Interleaved Bitmaps werden zum schnelleren Kopieren der Men -Boxen verwendet. - Die 3D-Images von MagicMenu werden jetzt auf die gesetzten DrawPens umgemapped, wenn nicht die Standardwerte verwendet werden. So bekommen jetzt auch Programme, mit un blichen DrawPen Ein- stellungen (z.B. PageStream 2.x, Term...), die erhabenen Symbole in den Men s. Bei Screens mit vielen Farben und un blichen DrawPens kann auf langsamen Rechnern eine kurze Pause zwischen dem Aktivieren und dem Darstellen des Men s bemerkbar werden. - Zum Erstellen der Men s werden (wieder) Layers verwendet, um Ab- st rze durch das "Menu-Caching"-Problem (siehe "Ungel ste Probleme" weiter unten) auszuschliessen. - Bei PressOnce und Select kann nun auch mit der linken Maustaste abgebrochen werden, wenn der Mauszeiger ausserhalb des Men s ist. (Vorschlag von Marc Jackish) - Ein erneuter Druck auf den Men -Hotkey bricht jetzt die Men auswahl ab. (Vorschlag von Stefan Stuntz) - Die Intuition-Men -Tastenkombination (rechte Alt und Amigataste) funtioniert jetzt genauso, wie die eingestellte Aktivierungssequenz. (Vorschlag von Michael Thiel und Magnus ? ) - Die Men leiste beim Pull-Down Men ist jetzt genauso gro wie die Screenleiste selbst. (Vorschlag von Reza Elghazi und vielen anderen) - Da der detach-Startupcode von SAS/C 6.0 jetzt auch das neue AmigaOS 2.0 Feature "progdir:" unterst tzt, kann MagicMenu ab sofort auch ohne RUN aus dem CLI gestartet werden, es koppelt sich selbst- t tig von diesem CLI ab. Ungel ste Probleme: - Einige Programme modifizieren ihre Men s ohne sie vorher mit ClearMenuStrip() abgemeldet zu haben. Das ist lt. den RKM-Richtlinien eine Tods nde. Intuition kommt damit (leider) zurecht, aber das "Menu-Chaching" von MagicMenu nicht. In einer sp teren Version wird das Menu-Caching f r einzelne Screens ausgeschaltet werden k nnen, bis dahin mu man damit leben. - In Kickstart 3.0 kamen einige neue DrawPens fuer die Men leiste dazu. Einige Programme (z.B. Euromail, Superbase Pro 1.0) setzen diese DrawPens auf unsinnige Werte. Unter 2.x hat das keine Aus- wirkungen, unter 3.0 richtet sich MagicMenu aber bei der Standard- Darstellung nach diesen Pens, was recht un bliche Farbeffekte her- vorrufen kann. (Anmerkung an Programmierer: Ja, ich werte dri_Version aus!). Folgende Fehler wurden beseitigt: - Wenn ein Programm ein eigenes CheckImage definiert, wurde bei der Standard-Darstellung ein nicht vorhandenes "NoCheckImage" (Symbol, wenn ein Men punkt nicht selekiert ist) bearbeitet und angezeigt. Das f hrte zu wilden Abst rzen. (Hinweis von Markus Bartsch und Candid B schen) - Magic Menu st rtzte unter 3.0 oft ab, u.a. wegen der skalierten Images f r das CheckMark und das Amigazeichen. Behoben. (Hinweis von unz hligen Usern...) - Alle Commodity-Hotkey Strings (aus den Tool Types und dem Prefs Fenster) wurden in Gro buchstaben umgewandelt, dadurch konnten keine Hotkey mit Buchstaben ohne Shift definiert werden. Behoben. (Hinweis von Hans Maurer) - Die diversen SunMouse Utilities machten Probleme, da das ActivateWindow() zum bekannten Deadlock f hrte. ActivateWindow() ist jetzt ebenfalls gepatched. (Hinweis von Marc Heuler) - Beim Men -Flag HIGHIMAGE wurde f lschlicherweise auch invertiert. @endnode @Node "Hist114" Revision V1.14 -------------- changed on Dienstag, 28-Okt-92 18:17:53 by Martin Kornd rfer. LogMessage : Folgende Fehler wurden beseitigt: - Es gab ein Problem in der Version 1.13 mit der Option CHECKWB: Bei allen Programmen, die ein AppMenu installieren, ndert sich n mlich das Men layout der Workbench... Ganz im Gegensatz zu meiner damaligen Behauptung... 8^} . Jetzt wird zus tzlich bei jedem SetMenuStrip() der Intuition gepr ft, ob sich die Anzahl der Eintr im Tools-Men ndert hat. Sollte es mit der Funktion irgendwelche Probleme geben, z.B. da das Tools Men nicht korrekt angezeigt wird, dann bitte CHECKWB auf NO stellen. Ungel ste Probleme: - Auf langsamen Rechnern kann es immer noch vorkommen, da der Rechner das Loslassen der rechten Maustaste " bersieht", wenn man die Taste extrem kurz dr Revision V1.13 -------------- changed on Montag, 26-Okt-92 16:47:38 by Martin Kornd rfer. LogMessage : Folgende Fehler wurden beseitigt: - Bei 1.3 Screens wurden die Farben falsch gew hlt. Jetzt gibt es nur zwei Darstellungen (so wie es auch logisch ist): Eine 3D-Darstellung, bei der die Farben geaendert werden muessen, und die Standarddarstel- lung, die automatisch bei 1.3 Screens gew hlt wird. (Hinweis von Markus Bartsch) - GFA-Bugsic hat offenbar die Angewohnheit, die Tastatur-Shortcuts erst NACH SetMenuStrip in die Strukturen einzubauen (oder einige Programme machen das so). Ist nat rlich problematisch, ich hoffe, Magic Menu kommt damit jetzt besser zurecht. - ndert ein Programm ein Men ohne SetMenuStrip() aufzurufen (z.B. ToolsDaemon), dann wird automatisch das Men neu berechnet, wenn die ge nderten Men punkte aufgerufen werden. - Bei der Standarddarstellung werden die Farben nicht mehr aus der SCREEN sondern der WINDOW Struktur entnommen - ich hoffe, jetzt passt es endlich... ;-) - Es gibt doch tats chlich ein Programm, da die Men s BUSY WAITING ber die CHECKED Flags abfr gt... ;-( Und dabei dann zus tzlich das Flag MENUTOGGLE nicht setzt. Dieses Flag soll laut RKM's einen Men punkt umschaltbar machen. Intuition ignoriert das Fehlen des Flags offensichtlich, Magic Menu sieht das jetzt auch etwas relaxter... (Hinweis von Michael Thiel) nderungen - Durch die "Vorausberechnung" der Men s bei SetMenuStrip() wird zwar die Darstellung der Men s beschleunigt, daf r werden allerdings Programme, die h ufig SetMenuStrip() aufrufen, gebremst. Eigentlich gibt es unter 2.0 daf r die Funktion ResetMenuStrip(), die nicht zu einer Neuberechnung f hrt... Leider benutzt die Workbench diese Funktion nicht konsequent. Deswegen habe ich ein neues Tool Type ("CHECKWB") eingef hrt, da Magic Menu dazu veranlasst, bei Auf- rufen der Workbench von SetMenuStrip() zu testen, ob das Men reits f r das Fenster installiert wurde und in diesem Fall die Neu- berechnung zu unterdr cken. Da die Workbench das Layout der Men nie ndert, sondern nur Men punkte en- und disabled, ist diese L sung unproblematisch. Revision V1.12 -------------- changed on Mittwoch, 22-Okt-92 16:34:08 by Martin Kornd rfer. LogMessage : nderungen: - Beim Pull Down Men wurde die Darstellung f r DoubleBorders = AUS ge ndert, Die Men s haben jetzt eine Art "Kartei"-Design. (Vorschlag von Andreas Schildbach) - SMARTPATCH Tool Type eingef hrt. Damit kann die berpr fung der Library Vektoren vor dem Uninstallieren abgeschaltet werden (SMARTPATCH=NO), f r den Fall das SaferPatches von Martin Adrian oder ein vergleichbares Programm benutzt wird. - CenterBoxes wurde modifiziert. Wenn in einem Men bereits eimal eine Auswahl stattgefunden hat, dann wird nicht mehr das ganze Men , son- dern der zuletzt aktivierte Men punkt um den Mauszeiger zentriert. (Vorschlag von Garry Glendown) Folgende Fehler wurden beseitigt: - In der Pop-Up Darstellung wurden bei Men s mit mehreren Spalten die Untermen s falsch positioniert. Beispiel: ClockDJ. (Hinweis von Ralph Sch - Bei der Standardarstellung wurden nicht alle Farben korrekt wieder- gegeben. - Wenn beim Pop-Up Men der "Men rper" eines (Unter-)men s den K des restlichen Men s (teilweise) berdeckt (z.B. wenn ein Men sehr breite Eintr ge hat) konnte es vorkommen, dass eigentlich ver- deckte Men punkte aktiviert wurden. (Hinweis von Michael Thiel) - In den Vorversionen wurden die InputEvents auf dem Stack allokiert und waren deswegen nicht notwendigerweise auf einer Langwort-Grenze, was zur Folge hatte, dass das console.device nichts damit anfangen konnte. Jetzt werden die Events mit AllocVec angefordert. Dadurch funktionieren auch alle Programme, die Men events ber das console.device abfragen (z.B. CSH). (Hinweis von Andreas Schildbach und Matthias M rstedt) Revision V1.11 -------------- changed on Freitag, 20-Okt-92 00:50:33 by Martin Kornd rfer. LogMessage : Folgende Fehler beseitigt: - Es konnte vorkommen, dass Magic Menu falsche Men werte an das Pro- gramm schickt. Dadurch wurde eine ungewollte Men funktion aufgeru- fen. (Hinweis von Kay Gehrke) - Bei DirectoryOpus konnte es vorkommen, dass die rechte Maustaste "steckenblieb", d.h. das Programm verhielt sich so, als ob man die Taste gedr ckt halten w rde, obwohl man sie l ngst losgelassen hat. (Hinweis von Toni G nzel-Peltner (WEGAR@AMC.ZER)) - Die Menuevents werden jetzt ber das input.device gesendet, dadurch bekommt jetzt auch ToolsDaemon mit, da die Prefs ge ffnet werden sollen. Das console.device k mmert sich aber leider auch darum nicht. (Hinweis von Thomas Mainz) - Ein bereits selektierter Men punkt konnte beim loslassen ein wei- teres mal selektiert werden, was bei MENUTOGGLE Men punkten zur Folge hatte, da sie wieder umgeschaltet wurden. Dieses Verhalten ist zwar eigentlich logisch und konsequent, aber Intuition macht es anders... ... und Magic Menu passt sich dem an. (Hinweis von S nke Brandt und Toni G nzel-Peltner) nderungen: - SetMenuStrip() beschleunigt. - DetailPen und BlockPen f r die 2-D Darstellung werden jetzt aus der Screen Struktur genommen, nicht mehr aus der DrawInfo. Revision V1.10 -------------- changed on Dienstag, 13-Okt-92 00:59:43 by Martin Kornd rfer. LogMessage : Folgende Fehler beseitigt: - CX_POPKEY wurde nicht erkannt. Der Popup String wird jetzt in der Fenster Leiste angezeigt (wie sich das geh rt) (Hinweis von Michael Hohmann) - Die Vektoren der gepatchten Intuition-Routinen werden vor der Restaurierung darauf berpr ft, ob sie von einem anderen Programm modifiziert worden sind, wenn dem so ist, kann Magic Menu nicht ent- fernt, sondern nur deaktiviert werden. - Wenn das CheckImage eines Fensters gesetzt war wurden trotzdem die Images von Magic Menu verwendet, jetzt wird das tats chlich einge- stellte Image verwendet (aber nur, wenn die Gr sse nicht dem Image von Intuition entspricht) (Hinweis von Markus Bartsch) - Die fertigen Versionen der 1.06 wurden f lschlicherweise mit der detach.o des SAS 5.10b gelinkt, was zur Folge hatte, da der Pfad "progdir:" nicht bekannt war (dieser Pfad ist ein neues Feature der KS 2.0, aber das daf tige (neue) Feld der Prozess-Struktur wird von detach.o nicht geklont). Ausserdem lief MagicMenu deswegen nicht auf 68040ern (A4000). (Hinweis von Detlev ? (TETISOFT@APG.ZER) und Markus Bartsch) - Wurde das Fenster von Magic Menu geschlossen, obwohl es gar nicht offen war ( ber Exchange) wurde mit wilden Pointern CloseWindow() und andere Routinen aufgerufen... ;-(. Nat rlich behoben. (Hinweis von S nke Brandt) - Das "Drag-Select", also das selektieren mehrere Men punkte mit gedr ckt gehaltener, linken Maustaste (bei Press Once: gedr ckter Shift-Taste) hat nicht wie beschrieben (und von Intuition vorgemacht) funktioniert. Sollte jetzt gehen. (Hinweis von S nke Brandt) Neue Features: - Die Daten jedes Menues werden gespeichert, so ist die Darstellung der Menues wesentlich schneller, da nicht jedesmal neu berechnet werden muss. - Daraus konnte dann das Feature entwickelt werden, dass sich Magic Menu zu jedem Men (inkl. Untermen s) den zuletzt angew hlten Punkt merkt, und beim n chsten Aufruf ber die Tastatur sofort anspringt. (Vorschlag von S nke Brandt, Markus Bartsch und Garry Glendown) nderungen: - Bei "Double Borders" werden die angew hlten Men punkte nicht mehr mit einem "eingedr ckten" sondern "herausragendem" Feld markiert. Das macht optisch einfach mehr Sinn. (Vorschlag von Michael Hohmann) @endnode @Node "Hist106" Revision V1.06 -------------- changed on Freitag, 02-Okt-92 13:19:46 by Martin Kornd rfer. LogMessage : Wenn der System-Font <> ScreenFont dann wurde das Men falsch berechnet und dargstellt. Fehler behoben. Einige Programme (MuchMore, TA) bekamen keine Events von der rechten Maustaste (was muessen die auch im Event-Stream rumpfuschen?! Sorry, Toni ... ;-) ). Behoben. Revision V1.05 -------------- changed on Mittwoch, 30-Sep-92 14:31:13 by Martin Kornd rfer. LogMessage : Umschaltung zwischen 3D- und 2D-Darstellung mit der Ctrl Taste m glich, w hrend das Men angezeigt wird. L dt Tool Types jetzt auch bei Start aus dem CLI. Die Darstellung von Farbauswahl-Men s wurde verbessert. Im Standardlook werden die Farben IMMER korrekt angezeigt. Im 3D-Look wird nur Farbe 0 f lschlicherweise als Farbe 1 angezeigt, das l t sich aber nicht vermeiden. @endnode @Node "Hist100" Revision V1.00 -------------- changed on Dienstag, 29-Sep-92 12:51:02 by Martin Kornd rfer. LogMessage : Inkompatibilit t mit DMouse und anderen Programmen beseitigt (G. Glendown) Darstellung der Men s noch kompatibler, einige Programme (TKEd) hatten so ihre Probleme mit der Vorversion. Revision V0.98 -------------- changed on Donnerstag, 24-Sep-92 21:25:12 by Martin Kornd rfer. LogMessage : Wedges f r folgende Intuition-Routinen eingebaut: OpenWindow, OpenWindowTagList, ClearMenuStrip, SetMenuStrip, ResetMenuStrip Routinen werden erst ausgef hrt, wenn Men verarbeitung abgeschlossen. Die Kontrolle dar ber wird mit 2 Semaphoren durchgef Gr e der Men boxen ge ndert (Vertikal 4 Pixel kleiner) Revision V0.97 -------------- changed on Donnerstag, 24-Sep-92 01:05:02 by Martin Kornd rfer. LogMessage : Tastatursteuerung im Einstellungsfenster eingebaut Double Borders eingebaut Revision V0.96 -------------- changed on Mittwoch, 23-Sep-92 23:23:39 by Martin Kornd rfer. LogMessage : Fehler beim Kopieren der Bilddaten aus dem Hintergrund behoben. Der Speicher wurde freigegeben, obwohl der Blitter (evtl.) noch gar nicht fertig war Revision V0.95 -------------- changed on Dienstag, 22-Sep-92 15:52:12 by Martin Kornd rfer. LogMessage : Tastatursteuerung verbessert (Buchstabenwahl) Eine Reihe von Enforcer-Hits entfernt Der Aufbau der Men s wurde deutlich beschleunigt (Kein Clipping mehr die Layers.library) Revision V0.90 -------------- changed on Montag, 21-Sep-92 17:03:55 by Martin Kornd rfer. LogMessage : Commodity Pop up Screen erstellt, ToolTypes k nnen gespeichert werden. Handling in allen Modi verbessert. Einige kleinere Fehler beseitigt. Revision V0.20 -------------- changed on Freitag, 18-Sep-92 00:10:58 by Martin Kornd rfer. LogMessage : Die drei Men -Modi (NORMAL, PRESSONCE, SELECT) eingebaut Tastensteuerung eingebaut Revision V0.10 -------------- changed on Donnerstag, 17-Sep-92 18:47:22 by Martin Kornd rfer. LogMessage : Men voll funktionsf Diverse Fehler in der Darstellung, besonders von 1.3 Men s, behoben. Alter "2D-Look" voll implementiert. Revision V0.02 -------------- changed on Mittwoch, 16-Sep-92 23:16:05 by Martin Kornd rfer. LogMessage : Grafikroutinen f r Pull Down Men s fertig Revision V0.01 -------------- --- Initial release --- @endnode @Node "Future" 6.2 Geplante Features ********************* Folgende Features sind f r zuk nftige Versionen von Magic Menu noch geplant: o F r jeden Screen getrennt einstellbare Preferences. o Damit verbunden nat rlich (endlich) eine komplett neue Oberfl o Lokalisierung der Oberfl o Trennung der Einstellungsoberfl che vom restlichen Programm o Die Einstellungen sollen als IFF File in ENV: gespeichert werden. es sind noch gute Ideen willkommen! @endnode @Node "Credits" 7.1 Credits *********** Das Programm Magic Menu wurde geschrieben von Martin Kornd Pommernstr. 15 D-86916 Kaufering E-Mail Adressen: Internet: korndorf@informatik.tu-muenchen.de Z-Netz : M.KORNDOERFER@NATHAN.ZER oder SYSOP@NATHAN.ZER Telefon: +49 8191 6383 Bitte teilt mir Bugs oder Programme, bei denen die Men s nicht korrekt dargestellt werden, mit! Die englische Anleitung wurde geschrieben von Garry Glendown Martin Kornd zus tzliche Arbeit und Korrekturen von Martin Huttenloher ... vielen Dank f r Eure hervorragende Arbeit, Martin & Garry! Die Oberfl che wurde gestaltet mit Hilfe der GadToolsBox 1.4 von Jan van den Baard ... thanx for this wonderful program!! Magic Menu wurde entwickelt mit Hilfe des SAS/C 5.10b / 6.1 C-Compilers Das Icon von MagicMenu wurde erstellt von Martin Huttenloher Die ersten, noch reichlich fehlerhaften Versionen wurden getestet von Angelika Nadler Olaf Lange Thomas Starke Quinten Martens Markus Bartsch Martin Neuhauser Dirk Taggesell r Hinweise und Bugreports danke ich (in alphabetischer Reihenfolge) Markus Bartsch, Candid B schen, S nke Brandt, Reza Elghazi, Kay Gehrke, Garry Glendown, Toni G nzel-Peltner, Marc Heuler, Michael Hohmann, Martin Huttenloher, Marc Jackisch, Thomas Mainz, Hans Maurer, Matthias M rstedt, Ralph Sch fer, Andreas Schildbach, Stefan Stuntz, Dirk Taggesell, Christoph T uber, Michael Thiel und den vielen anderen die mir geschrieben haben. Ausserdem danke ich Kai Iske ... f r sein KCommodity, und vorallem der CRevision. Stefan Stuntz ... f r sein MFR und die Idee f r den Namen ... ;-) Garry Glendown ... f r seine Tips zum SAS/C Compiler und das Patchen von Funktionen. Gewidmet sind die Magic Menus Angel ... you're simply magic! @endnode @Node "Licence" 7.2 Erkl rung & Nutzungsbedingungen (DISCLAIMER) ************************************************ No Warranty ----------- THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Magic Menu 1992/93 Martin Kornd Magic Menu ist *NICHT* Public Domain! Das Copyright auf Magic Menu verbleibt in jedem Fall beim Autor! Das Programm darf nur zusammen mit folgenden Dateien weitergegeben werden: MagicMenu MagicMenu.info Deutsch/MagicMenu.guide Deutsch/MagicMenu.guide.info Deutsch/Benchmark Deutsch/Benchmark.info Deutsch/History Deutsch/History.info English/MagicMenu.guide English/MagicMenu.guide.info English/Benchmark English/Benchmark.info English/History English/History.info Solange keine der obigen Dateien weggelassen oder ver ndert wird, darf Magic Menu frei auf Diskette oder ber Datennetze verbreitet werden. Eine Diskette, auf der sich Magic Menu befindet, darf nicht mehr als eine AmigaLibDisk bei Fred Fish kosten. @endnode